Skip to content

Conversation

@ahouseholder
Copy link
Contributor

Copilot Summary

This pull request introduces a new architectural decision record (ADR) that formalizes the versioning scheme for the SSVC project and its documentation. The main change is the adoption of Calendar Versioning (CalVer) for project-level releases, while maintaining Semantic Versioning (SemVer) for individual SSVC objects. Additionally, the ADR index is updated to reference this new decision.

Versioning policy update:

  • Added a new ADR (docs/adr/0013-ssvc-project-versions.md) specifying that the SSVC project and documentation will use Calendar Versioning (YYYY.MM.patch), while individual objects will continue to use Semantic Versioning.
  • Clarified the rationale, consequences, and implementation details of CalVer, including how releases will be tagged and how this differs from previous SemVer usage.

Documentation update:

  • Updated the ADR index (docs/adr/index.md) to include the new versioning decision record.

@ahouseholder ahouseholder added this to the 2025-09 milestone Sep 15, 2025
@ahouseholder ahouseholder self-assigned this Sep 15, 2025
@ahouseholder ahouseholder added the content/semantic Changes to the semantic content of the SSVC documentation label Sep 15, 2025
@ahouseholder ahouseholder requested a review from j--- as a code owner September 15, 2025 17:08
@ahouseholder ahouseholder added the tech/backend Back-end tools, code, infrastructure label Sep 15, 2025
@ahouseholder ahouseholder merged commit fb459e1 into main Sep 15, 2025
5 checks passed
@ahouseholder ahouseholder deleted the calver_adr branch September 15, 2025 19:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content/semantic Changes to the semantic content of the SSVC documentation tech/backend Back-end tools, code, infrastructure

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define main SSVC versioning strategy in an ADR

3 participants